Options

Set publisher specific options.

Child elements

(none)

Parent elements

AtPageCreation, AtPageShipout, Case, Contents, ForAll, Include, Layout, Loop, Otherwise, Record, SavePages, Until, While

Attributes

background-color (text, optional, since version 4.19.11)

Render colored background behind each page. Defaults to 'white'. State a color name or '-' for no background.

bleed (length, optional)PRO

The amount of bleed. Defaults to 0mm.

bleedmarks (optional, since version 2.3.24)PRO

Trim marks will be placed in the PDF. The distance of the marks from the imaginary center is determined by the attribute trim, but is at least 5mm. The length of the cut marks is 1cm. The default of this attribute is no, that means no trim marks will be displayed. The trim marks show the additional trim distance.

yes

Show trim marks.

no

Don’t show trim marks (default).

crop (yes, no or length, optional, since version 2.3.21)

Crop the pages so that the pdf size of the page is at its minimum. Allowed values are yes, no and a length.

cutmarks (optional)PRO

Cut marks / crop marks will be placed in the PDF. The distance of the marks from the imaginary center is determined by the attribute trim, but is at least 5mm. The length of the cut marks is 1cm. The default of this attribute is no, that means no cut marks will be displayed.

yes

Show crop marks.

no

Don’t show crop marks (default).

defaultarea (text, optional, since version 2.7.4)

Name of the area that is used as a default for placing text (commands Output and PlaceObject). Default is _page.

fontexpansion (optional, since version 4.19.17)

Allow glyph stretching and shrinking. Default is 'yes'.

no

Do not allow font stretching or shrinking.

some

Stretching and shrinking is applied after the line break.

yes

Stretching and shrinking is applied before linebreak, so the line breaking algorithm has more possible break points thus leading to a “better” visual appearance.

fontshrink (number, optional, since version 4.19.17)

Set the default maximum shrinkage factor of the fonts. Default is disabled. Values divided by 10 = percent. For example 20 means shrink by maxium of 2%.

fontstep (number, optional, since version 4.19.17)

Set the default step values for shrinkage / stretching. Value divided by 10 is step in percentage. For example: a value of 20 means increase / decrease size in 2% steps. Default 10.

fontstretch (number, optional, since version 4.19.17)

Set the default maximum stretch factor of the fonts. Default is disabled. Values divided by 10 = percent. For example 20 means stretch by maxium of 2%.

ignoreeol (optional)

Ignore newlines in data-xml

yes

Ignore newlines in data-xml

no

Respect newlines in data-xml

imagenotfound (optional, since version 2.3.43)

When an image is not found: should the publisher raise an error?

warning

Show a warning

error

Raise an error (default)

interaction (yes or no, optional, since version 3.9.2)

If no, switch off all interaction (hyperlinks).

mainlanguage (optional)

The default language for text (hyphenation and rendering). You can also set the default language on the command line and locally set it at Paragraph and Textblock.

markdown-extensions (text, optional, since version 4.17.11)

Set the markdown extensions. Must be a comma seprarated list of one or more of these values: table, strikethrough, linkify, tasklist, gfm, definitionlist, footnote, typographer, cjk.

overfull-line (optional, since version 4.19.10)

Raise a warning or an error if a text line is too wide for a text block.

warning

Show a warning

error

Raise an error

ignore

Ignore this case (default).

randomseed (number, optional, since version 3.9.24)

Set the seed for the random number generator (a positive integer).

reportmissingglyphs (optional, since version 3.1.17)

Issue an error if glyphs are missing from a font.

yes

Show error message (default)

no

Do not show an error message

warning

Show a warning

resetmarks (optional)

Yes: ignore the marks file from previous run.

yes

Ignore marks from the previous run.

no

Use marks from the previous run (default).

startpage (number, optional)

Set the number of the first page.

Remarks

Bleed used to be 'trim' in version 2.7.6 and before.

Example

<Options
    cutmarks="yes"
    bleed="3mm"/>

Info

The list of languages and the short code known to the system are:

Ancient Greek (grc), Armenian (hy), Bahasa Indonesia (id), Basque (eu), Bulgarian (bg), Catalan (ca), Chinese (zh), Croatian (hr), Czech (cs), Danish (da), Dutch (nl), English (en_GB), English (Great Britain) (en_GB), English (USA) (en_US), Esperanto (eo), Estonian (et), Finnish (fi), French (fr), Galician (gl), German (de), Greek (el), Gujarati (gu), Hindi (hi), Hungarian (hu), Icelandic (is), Irish (ga), Italian (it), Kannada (kn), Kurmanji (ku), Latvian (lv), Lithuanian (lt), Malayalam (ml), Norwegian Bokmål (nb), Norwegian Nynorsk (nn), Other (--), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Sanskrit (sa), Serbian (sr), Serbian (cyrillic) (sc), Slovak (sk), Slovenian (sl), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk), Welsh (cy)

See also

Running the speedata publisher on the command line, How to configure the speedata publisher, Print output / crop marks.